================================================================================
                         ETHEREAL WM HOST - Quick Start Guide
                                  Version 1.0.0
================================================================================

Thank you for downloading Ethereal Host! This application streams your Windows 
apps to your VR headset with AR passthrough.

--------------------------------------------------------------------------------
                              REQUIREMENTS
--------------------------------------------------------------------------------

  • Windows 10 (version 1903 or later) - 64-bit
  • NVIDIA or AMD graphics card with hardware encoding support
  • Same WiFi network as your VR headset

--------------------------------------------------------------------------------
                              INSTALLATION
--------------------------------------------------------------------------------

  1. Run "EtherealHost-1.0.0-Setup.exe"
  
  2. If Windows SmartScreen appears, click "More info" → "Run anyway"
  
  3. Follow the installation wizard:
     - Accept the license agreement
     - Choose installation folder (default is recommended)
     - CHECK "Configure Windows Firewall rules" ← IMPORTANT!
     - Click Install
  
  4. Launch Ethereal Host from the Start Menu or Desktop shortcut

--------------------------------------------------------------------------------
                              FIRST TIME SETUP
--------------------------------------------------------------------------------

  1. Launch Ethereal Host on your PC
     - The application will show your PC's IP address and connection status
  
  2. On your Quest headset:
     - Open the Ethereal Client app
     - It will automatically discover your PC on the network
     - Select your PC from the list
  
  3. Once connected:
     - You'll see a list of available windows
     - Click on any window to start streaming it to your headset

--------------------------------------------------------------------------------
                              USING THE APP
--------------------------------------------------------------------------------

  STREAMING WINDOWS:
  - Click on a window title to start streaming
  - The window will appear as a floating panel in VR
  - You can stream multiple windows at once

  INTERACTING WITH WINDOWS:
  - Pinch to click (like tapping a touchscreen)
  - Pinch + move up/down to scroll
  - Pinch + hold + move to drag
  - Use the virtual keyboard for typing

  STOPPING A STREAM:
  - In VR, use the close button on the window panel
  - Or stop from the host application

--------------------------------------------------------------------------------
                              TROUBLESHOOTING
--------------------------------------------------------------------------------

  "Quest can't find my PC"
  ────────────────────────
  • Make sure both devices are on the SAME WiFi network
  • Check that Windows Firewall rules are configured:
    - Run PowerShell as Admin
    - Run: Get-NetFirewallRule -DisplayName "Ethereal*"
    - You should see 3 rules listed
  • Try disabling VPN if you have one active

  "Video is laggy or stuttering"
  ──────────────────────────────
  • Use 5GHz WiFi, not 2.4GHz
  • Move closer to your WiFi router
  • Close bandwidth-heavy apps on your network
  • Check that hardware encoding is being used (NVENC/AMF)

  "Black screen in VR"
  ────────────────────
  • Make sure the window isn't minimized on your PC
  • Try restarting the stream
  • Check the host app for any error messages

  "Clicks aren't working"
  ───────────────────────
  • Make sure you're pinching on the correct window panel
  • The window must be in focus on your PC

--------------------------------------------------------------------------------
                              NETWORK PORTS
--------------------------------------------------------------------------------

  Ethereal Host uses these ports (configured automatically during install):

  • TCP 9876  - WebSocket signaling (control messages)
  • UDP 9877  - Host discovery (finding your PC)
  • UDP 9999  - Video/audio streaming and input

  If you have a third-party firewall, you may need to allow these manually.

--------------------------------------------------------------------------------
                              UNINSTALLING
--------------------------------------------------------------------------------

  1. Go to Control Panel → Programs → Uninstall a Program
  2. Find "Ethereal Host" and click Uninstall
  3. The uninstaller will remove all files and firewall rules

--------------------------------------------------------------------------------
                              SUPPORT
--------------------------------------------------------------------------------

  For help, bug reports, or feature requests:
  
  Email: support@ethereal.glass
  


================================================================================
                          ETHEREAL WM v1.0.0a
                         User Instructions Guide
================================================================================

Welcome to Ethereal WM! Stream your PC windows into augmented reality on your 
Meta Quest headset. See your desktop apps as floating 3D panels in your real 
environment.

================================================================================
                              TABLE OF CONTENTS
================================================================================

  1. REQUIREMENTS
  2. INSTALLATION
  3. GETTING STARTED
  4. HAND TRACKING CONTROLS
  5. CONTROLLER CONTROLS
  6. WINDOW MANAGEMENT
  7. FEATURES OVERVIEW
  8. TIPS & BEST PRACTICES
  9. TROUBLESHOOTING
  10. KNOWN LIMITATIONS
  11. FEEDBACK & SUPPORT

================================================================================
                              1. REQUIREMENTS
================================================================================

QUEST HEADSET:
  • Meta Quest 2, Quest 3, or Quest Pro
  • Developer Mode enabled (required for sideloading)
  • Latest Quest firmware recommended

WINDOWS PC (Host):
  • Windows 10 or Windows 11
  • Connected to the same WiFi network as your Quest
  • Ethereal Host application running

NETWORK:
  • Both devices must be on the same local network
  • 5GHz WiFi recommended for best performance
  • Low latency connection (ideally < 20ms to router)

================================================================================
                              2. INSTALLATION
================================================================================

QUEST CLIENT:
  1. Enable Developer Mode on your Quest (via Meta phone app)
  2. Connect Quest to PC via USB cable
  3. Allow USB debugging when prompted on Quest
  4. Install APK using: adb install EtherealClient-debug.apk
  5. Find "Ethereal" in your Quest app library (Unknown Sources)

HOST APPLICATION:
  1. Run the Ethereal Host application on your Windows PC
  2. Ensure Windows Firewall allows Ethereal through
  3. The host will automatically start broadcasting on your network

================================================================================
                            3. GETTING STARTED
================================================================================

LAUNCHING THE APP:
  1. Put on your Quest headset
  2. Launch "Ethereal" from your app library
  3. You'll see your real environment with AR passthrough enabled

CONNECTING TO YOUR PC:
  1. The app will automatically discover Ethereal hosts on your network
  2. Available hosts appear as buttons in front of you
  3. Point at your PC's hostname and pinch/click to connect
  4. Wait a few seconds for the connection to establish

SELECTING WINDOWS:
  1. After connecting, you'll see a grid of available windows
  2. Each window shows its icon and title
  3. Point at a window and pinch/click to start streaming
  4. The window appears as a floating 3D panel in your space

================================================================================
                          4. HAND TRACKING CONTROLS
================================================================================

The app features full hand tracking with intuitive gesture controls:

POINTING:
  • Point your hand at panels to see a cursor dot
  • A short beam extends from your pinch point (thumb-index midpoint)
  • The cursor appears where your ray hits a panel

CLICKING (Quick Pinch):
  • Make a quick pinch gesture (< 250ms)
  • This sends a left-click to the window at the cursor location
  • Works just like clicking with a mouse

SCROLLING:
  • Pinch and hold, then move your hand UP or DOWN
  • Vertical movement is converted to scroll wheel events
  • Release pinch when done scrolling

DRAGGING:
  • Pinch and hold for ~450ms, then move your hand
  • This initiates a drag operation (like holding mouse button)
  • Great for selecting text, moving sliders, dragging files
  • Release pinch to end the drag

MOVING PANELS (Grab Bar):
  • Each panel has a white pill-shaped GRAB BAR below it
  • Point at the grab bar - it will grow and brighten when hovering
  • Pinch on the grab bar to grab the panel
  • Move your hand to reposition the panel in 3D space
  • Push/pull hand forward/back to adjust distance
  • Panel automatically rotates to face you
  • Release pinch to drop the panel

================================================================================
                          5. CONTROLLER CONTROLS
================================================================================

You can also use your Quest controllers:
**CONTROLLER INPUT WORK IN PROGRESS**

MOVING PANELS:
  • Point at the grab bar below a panel
  • Hold trigger fully while pointing at grab bar
  • Move controller to reposition panel
  • Release trigger to drop

================================================================================
                          6. WINDOW MANAGEMENT
================================================================================

ADDING MORE WINDOWS:
  • Look for the floating "+" button in the bottom-right of your view
  • Click it to return to the window selection grid
  • Select additional windows to stream multiple at once

CLOSING WINDOWS:
  • Each panel has a circular X button in the top-right corner
  • Point at the X button (it will highlight)
  • Pinch/click to close that panel and stop streaming

KEYBOARD INPUT (Coming Soon):
  • Each panel has a keyboard button icon above it
  • This feature is currently in development
  • Will allow typing with a virtual keyboard

PANEL BUTTONS LOCATION:
  ┌────────────────────────────────────────────────┐
  │                                        ⌨  ✕   │  <- Keyboard & Close buttons
  │                                                │
  │              [Window Content]                  │
  │                                                │
  │                                                │
  └────────────────────────────────────────────────┘
                     ═══════════                      <- Grab Bar

================================================================================
                          7. FEATURES OVERVIEW
================================================================================

✅ WORKING FEATURES:

  AR Passthrough Mode
    • Full-color passthrough lets you see your real environment
    • Panels float naturally in your physical space

  Multi-Window Streaming
    • Stream multiple PC windows simultaneously
    • Each window is independent with its own input handling

  Low-Latency Video
    • Hardware-accelerated H.264 video decoding
    • Optimized for minimal motion-to-photon latency

  Full Hand Tracking
    • 26-joint skeleton tracking for precise interaction
    • GPU-skinned hand mesh rendering with Meta Quest-style visuals
    • Hands have a subtle rim glow effect

  Hand Mesh Visualization
    • Your hands are rendered with realistic translucent mesh
    • Fresnel rim lighting for depth perception

  Panel Interaction
    • Click anywhere on panels to interact with PC apps
    • Scroll through documents and webpages
    • Drag to select text or move UI elements

  6DOF Panel Movement
    • Grab and move panels anywhere in 3D space
    • Panels automatically face you when grabbed
    • Push/pull to adjust viewing distance

  Auto Host Discovery
    • Automatically finds Ethereal hosts on your network
    • No manual IP address entry required

  Window Icons
    • See application icons in the window selection grid
    • Easy identification of which app is which

================================================================================
                        8. TIPS & BEST PRACTICES
================================================================================

FOR BEST STREAMING QUALITY:
  • Use 5GHz WiFi for lower latency
  • Position your router for clear line of sight
  • Close bandwidth-heavy applications on your PC
  • Avoid streaming very large resolution windows

FOR COMFORTABLE VIEWING:
  • Position panels at arm's length (about 2 meters away)
  • Arrange panels in an arc around you for easy viewing
  • Tilt panels slightly toward you if needed

FOR ACCURATE INTERACTION:
  • Keep your hands in view of the Quest cameras
  • Make deliberate pinch gestures (not too fast or slow)
  • For clicking, use a quick pinch-release motion
  • For scrolling/dragging, hold the pinch while moving

ORGANIZING YOUR WORKSPACE:
  • Place reference materials (docs, chat) to your sides
  • Keep your main work window directly in front
  • Stack related windows together

================================================================================
                           9. TROUBLESHOOTING
================================================================================

CAN'T FIND HOST:
  • Ensure both devices are on the same WiFi network
  • Check that Ethereal Host is running on your PC
  • Check Windows Firewall isn't blocking Ethereal
  • Try restarting both the Quest app and PC host

CONNECTION DROPS:
  • Move closer to your WiFi router
  • Reduce network congestion (pause downloads, etc.)
  • Check for WiFi interference from other devices

VIDEO IS CHOPPY/FROZEN:
  • Ensure stable network connection
  • Try closing and reopening the specific window
  • Reduce the window size on your PC if very large

CLICKS NOT REGISTERING:
  • Make sure you're making a complete pinch gesture
  • Keep your hand steady when clicking
  • Ensure cursor is actually on the panel content

PANELS NOT APPEARING:
  • Wait a few seconds after selecting a window
  • Try selecting a different window
  • Restart the app if issue persists

HANDS NOT TRACKING:
  • Ensure good lighting in your room
  • Keep hands in view of Quest cameras
  • Avoid wearing gloves or covering your hands

================================================================================
                          10. KNOWN LIMITATIONS
================================================================================

CURRENT LIMITATIONS:

  • Audio Streaming - Not yet implemented
    PC audio is not streamed to your headset

  • Right-Click - Not yet supported
    Only left-click mouse events are sent

  • Touch/Tablet Input - Not supported
    Only mouse-style input is available

  • Panel Resize - Not yet implemented
    Panels have fixed aspect ratio based on window size

GENERAL NOTES:

  • First-time connection may take a few seconds
  • Some DRM-protected content may show as black
  • Very high resolution windows may have reduced frame rate
  • The app requires a stable WiFi connection throughout use

================================================================================
                         11. FEEDBACK & SUPPORT
================================================================================

This is an ALPHA release (v1.0.0a). We appreciate your feedback!

REPORTING ISSUES:
  When reporting problems, please include:
  • Quest model (Quest 2/3/Pro)
  • Windows version
  • Router/network setup
  • Steps to reproduce the issue
  • Any error messages seen

FEATURE REQUESTS:
  We're actively developing new features including:
  • Audio streaming
  • Right-click support
  • Panel resizing
  • Settings panel

================================================================================
                              QUICK REFERENCE
================================================================================

  HAND GESTURES:
  ┌─────────────────────────────────────────────────────────────────────────┐
  │  Quick Pinch            =  Click                                        │
  │  Pinch + Move Up/Down   =  Scroll                                       │
  │  Pinch + Hold + Move    =  Drag                                         │
  │  Pinch on Grab Bar      =  Move Panel                                   │
  │  Pinch on X Button      =  Close Panel                                  │
  │  Pinch on + Button      =  Add More Windows                             │
  └─────────────────────────────────────────────────────────────────────────┘

  CONTROLLER:
  ┌─────────────────────────────────────────────────────────────────────────┐                      
  │  Trigger on Grab Bar    =  Move Panel                                   │
  │  Move controller back/forward  =  Push/Pull Distance                    │
  └─────────────────────────────────────────────────────────────────────────┘

================================================================================

Thank you for testing Ethereal WM! Enjoy your AR desktop experience.

                              - The Ethereal Team -
--------------------------------------------------------------------------------
                     Copyright © 2025-2026 Ethereal Inc.
                            All Rights Reserved.
================================================================================

================================================================================
                           VERSION: 1.0.0a (Alpha)
                           Last Updated: January 2026
================================================================================
